home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / intgif11.zip / INTGIF11.DOC < prev    next >
Text File  |  1991-04-26  |  6KB  |  155 lines
  1. IntGIF v.1.1  -  GIF FIle Interrogator
  2. Copyright (c) 1990, EUROPA Software.
  3. Revision Date: August 12
  4.  
  5. -=[ Beg ]=-
  6.  
  7. If you find this program useful, please send a small contribution to a
  8. worthwhile charity such as the American Cancer Society, The Sierra Club
  9. or any other such organization that helps to make the world a better
  10. place to live. Also, feel free to send any 'kind' comments or suggestions
  11. about the program.
  12.  
  13.    Send any responses to:  J. E. Clary
  14.                            EUROPA Software
  15.                            314 Pleasant Meadows Dr.
  16.                            Gaffney, SC 29340
  17.  
  18.    EXEC-PC Messages to: Jay Clary
  19.  
  20. Reguardless of any donation or contribution, use the program in good health
  21. ( and with a clear concious ).
  22.  
  23.  
  24. -=[ Description ]=-
  25.  
  26. IntGIF is a utility program to interrogate the contents of GIF Picture
  27. files as defined by CompuServe in the 87GIFa GIF standard. IntGIF
  28. will display information from the Screen Descriptor (one per file)
  29. and the information from the Image Descriptor(s) (can be more that one
  30. in each file).
  31.  
  32.  
  33. -=[ Purpose ]=-
  34.  
  35. IntGIF was written to help catalogue various GIF images into distinct
  36. groups, based on the screen requirements for each image (i.e. EGA,VGA).
  37.  
  38.  
  39. -=[ Usage ]=-
  40.  
  41. Command Line Usage is:  IntGIF  /E | /M | /S [/R] [filespec]
  42.  
  43. IntGIF is to be invoked from the command line with one mandatory
  44. parameter. This parameter is the level of description IntGIF will display.
  45.  
  46.    The allowable options are:  /E = Extensive Amount of Information
  47.                                /M = Medium Amount of Information
  48.                                /S = Small Amount of Information
  49.  
  50.    There are two other allowable options, although they are only
  51.    used to show a brief help message about how to run the program.
  52.  
  53.                                /? = Show a help screen
  54.                                /H = Show a help screen
  55.  
  56.    The remaining possible option is the /R parameter. If you include
  57.    this in your command line, IntGIF will do a recursive directory
  58.    search for any subdirectory beneath current directory or the
  59.    specified path (if one is given in the filespec).
  60.  
  61. An additional parameter may be provided, although it is not mandatory,
  62. to specify the filespec to be used for searching. Follow the limitations
  63. of the DOS filespec when using this parameter i.e. Path and Wildcards are
  64. acceptable. If this last parameter is not provided on the command line,
  65. the user will be prompted for a filespec at runtime.
  66.  
  67. The output from IntGIF normally goes to the standard output device which
  68. is by default the screen. However, output may be redirected to another
  69. device, such as a disk file or the printer by letting DOS redirect the
  70. output via the > or >> symbol at the end of the command line.
  71.  
  72.  
  73.    Example Invokations:
  74.  
  75.    IntGIF /S /R c:\*.*
  76.  
  77.          Begin in the root directory of drive 'C', recursively search for
  78.          subdirectories and report the small amount of information as
  79.          requested by the /S parameter.
  80.  
  81.    IntGIF /E c:\pics\*.* >> gifs.lst
  82.  
  83.          Begin in the directory of drive 'c:\pics', only search the specified
  84.          subdirectories and report the extensive amount of information as
  85.          requested by the /E parameter. Redirect the standard output to a
  86.          disk file named 'gifs.lst'.
  87.  
  88.    IntGIF /M /R
  89.  
  90.          No filespec given, IntGIF will prompt the user for a filespec.
  91.          After it is given, IntGIF will begin in the that directory and
  92.          do a recursive directory search and report the medium amount of
  93.          information as requested by the /M parameter.
  94.  
  95.  
  96. -=[ Implementation ]=-
  97.  
  98. IntGIF is written in Turbo Pascal v.5.5
  99.  
  100.  
  101. -=[ Limitations ]=-
  102.  
  103. I).
  104.  
  105. CompuServe has provided a controlled path for extending the GIF standard.
  106. This path is known as an Extension Block. IntGIF 1.1, as of yet, is not
  107. capible of interpreting the Extension Block information, althought it will
  108. detect and read past them. The reason for the lack of interpretation is that
  109. that I have yet to see a GIF file with an Extension Block, and I do not
  110. beleive that they are being implemented yet. Future versions of IntGIF will
  111. be capible of giving details as to the functions being requested in the blocks
  112. and what these functions are supposed to do. This will be implemented as soon
  113. as CompuServe expands the GIF standard and defines these extended functions.
  114.  
  115. If you have a GIF file with Extentions in it, or you know of any details
  116. about the Extension Block (as I am not a member of CompuServe) please contact
  117. me about it.
  118.  
  119. II).
  120.  
  121. There is limited detection of corrupt GIF file images, as far as errors
  122. go within the LZW data stream. This seems to be a tricky piece of coding
  123. to branch in the event of an error, without making the code a mish-mash of
  124. IF THEN ELSE statements or, GOD FORBID, a goto statement. Not to fear, I
  125. am working on a 'structured' resolution to the problem and will get a handle
  126. on it eventually.
  127.  
  128.  
  129. -=[ Further Information ]=-
  130.  
  131. There is a document named 'GIFSTD.---' where --- may be ZIP, LZH, ARC, DOC
  132. or TXT that details the GIF87a standard. The document originated at
  133. CompuServe and is a very good reference as to the structure of a GIF file.
  134. This document is availible on the CompuServe system and on many other
  135. BBS systems across the country. There is also information floating around
  136. about the LZW compression/decompression process. Feel free to contact me
  137. for more details.
  138.  
  139.  
  140. -=[ Legal Nonsense ]=-
  141.  
  142. IntGIF is provided AS IS with no expressed or implied waranties, what so
  143. ever. EUROPA Software, nor any of it's employees shall be held responsible
  144. for any incidental or consequential damage resulting from the use or the
  145. inability to use this program.
  146.  
  147. Turbo Pascal is Copyrighted by Borland International.
  148. GIF is a TradeMark of CompuServe Incorporated, an H&R Block Company.
  149. ZIP is Copyrighted and is a TradeMark of PKWARE.
  150. ARC is Copyrighted by SEA Associatives.
  151. LZH is Copyrighted by Yoshi of Japan.
  152.  
  153.  
  154. -=[ Live Long, and Prosper ]=- <EOF>
  155.